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Abstract 


This document describes loss detection and congestion control mechanisms for QUIC. 


Status of This Memo 


This is an Internet Standards Track document. 


This document is a product of the Internet Engineering Task Force (IETF). It represents the 
consensus of the IETF community. It has received public review and has been approved for 
publication by the Internet Engineering Steering Group (IESG). Further information on Internet 
Standards is available in Section 2 of RFC 7841. 


Information about the current status of this document, any errata, and how to provide feedback 
on it may be obtained at https://www.rfc-editor.org/info/rfc9002. 
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1. Introduction 


QUIC is a secure, general-purpose transport protocol, described in [QUIC-TRANSPORT]. This 
document describes loss detection and congestion control mechanisms for QUIC. 


2. Conventions and Definitions 


The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD 
NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to 
be interpreted as described in BCP 14 [RFC2119] [RFC8174] when, and only when, they appear in 
all capitals, as shown here. 


Definitions of terms that are used in this document: 


Ack-eliciting frames: All frames other than ACK, PADDING, and CONNECTION CLOSE are 
considered ack-eliciting. 
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Ack-eliciting packets: Packets that contain ack-eliciting frames elicit an ACK from the receiver 
within the maximum acknowledgment delay and are called ack-eliciting packets. 


In-flight packets: Packets are considered in flight when they are ack-eliciting or contain a 
PADDING frame, and they have been sent but are not acknowledged, declared lost, or 
discarded along with old keys. 


3. Design of the QUIC Transmission Machinery 


All transmissions in QUIC are sent with a packet-level header, which indicates the encryption 
level and includes a packet sequence number (referred to below as a packet number). The 
encryption level indicates the packet number space, as described in Section 12.3 of [QUIC- 
TRANSPORT]. Packet numbers never repeat within a packet number space for the lifetime of a 
connection. Packet numbers are sent in monotonically increasing order within a space, 
preventing ambiguity. It is permitted for some packet numbers to never be used, leaving 
intentional gaps. 


This design obviates the need for disambiguating between transmissions and retransmissions; 
this eliminates significant complexity from QUIC's interpretation of TCP loss detection 
mechanisms. 


QUIC packets can contain multiple frames of different types. The recovery mechanisms ensure 
that data and frames that need reliable delivery are acknowledged or declared lost and sent in 
new packets as necessary. The types of frames contained in a packet affect recovery and 
congestion control logic: 


* All packets are acknowledged, though packets that contain no ack-eliciting frames are only 
acknowledged along with ack-eliciting packets. 


* Long header packets that contain CRYPTO frames are critical to the performance of the QUIC 
handshake and use shorter timers for acknowledgment. 


e Packets containing frames besides ACK or CONNECTION CLOSE frames count toward 
congestion control limits and are considered to be in flight. 


e PADDING frames cause packets to contribute toward bytes in flight without directly causing 
an acknowledgment to be sent. 


4. Relevant Differences between QUIC and TCP 


Readers familiar with TCP's loss detection and congestion control will find algorithms here that 
parallel well-known TCP ones. However, protocol differences between QUIC and TCP contribute 
to algorithmic differences. These protocol differences are briefly described below. 
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4.1. Separate Packet Number Spaces 


QUIC uses separate packet number spaces for each encryption level, except 0-RTT and all 
generations of 1-RTT keys use the same packet number space. Separate packet number spaces 
ensures that the acknowledgment of packets sent with one level of encryption will not cause 
spurious retransmission of packets sent with a different encryption level. Congestion control and 
round-trip time (RTT) measurement are unified across packet number spaces. 


4.2. Monotonically Increasing Packet Numbers 


TCP conflates transmission order at the sender with delivery order at the receiver, resulting in 
the retransmission ambiguity problem [RETRANSMISSION]. QUIC separates transmission order 
from delivery order: packet numbers indicate transmission order, and delivery order is 
determined by the stream offsets in STREAM frames. 


QUIC's packet number is strictly increasing within a packet number space and directly encodes 
transmission order. A higher packet number signifies that the packet was sent later, and a lower 
packet number signifies that the packet was sent earlier. When a packet containing ack-eliciting 
frames is detected lost, QUIC includes necessary frames in a new packet with a new packet 
number, removing ambiguity about which packet is acknowledged when an ACK is received. 
Consequently, more accurate RTT measurements can be made, spurious retransmissions are 
trivially detected, and mechanisms such as Fast Retransmit can be applied universally, based 
only on packet number. 


This design point significantly simplifies loss detection mechanisms for QUIC. Most TCP 
mechanisms implicitly attempt to infer transmission ordering based on TCP sequence numbers -- 
a nontrivial task, especially when TCP timestamps are not available. 


4.3. Clearer Loss Epoch 


QUIC starts a loss epoch when a packet is lost. The loss epoch ends when any packet sent after the 
start of the epoch is acknowledged. TCP waits for the gap in the sequence number space to be 
filled, and so if a segment is lost multiple times in a row, the loss epoch may not end for several 
round trips. Because both should reduce their congestion windows only once per epoch, QUIC 
will do it once for every round trip that experiences loss, while TCP may only do it once across 
multiple round trips. 


4.4. No Reneging 


QUIC ACK frames contain information similar to that in TCP Selective Acknowledgments (SACKs) 
[RFC2018]. However, QUIC does not allow a packet acknowledgment to be reneged, greatly 
simplifying implementations on both sides and reducing memory pressure on the sender. 
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4.5. More ACK Ranges 


QUIC supports many ACK ranges, as opposed to TCP's three SACK ranges. In high-loss 
environments, this speeds recovery, reduces spurious retransmits, and ensures forward progress 
without relying on timeouts. 


4.6. Explicit Correction for Delayed Acknowledgments 


QUIC endpoints measure the delay incurred between when a packet is received and when the 
corresponding acknowledgment is sent, allowing a peer to maintain a more accurate RTT 
estimate; see Section 13.2 of [QUIC-TRANSPORT]. 


4.7. Probe Timeout Replaces RTO and TLP 


QUIC uses a probe timeout (PTO; see Section 6.2), with a timer based on TCP's retransmission 
timeout (RTO) computation; see [RFC6298]. QUIC's PTO includes the peer's maximum expected 
acknowledgment delay instead of using a fixed minimum timeout. 


Similar to the RACK-TLP loss detection algorithm for TCP [RFC8985], QUIC does not collapse the 
congestion window when the PTO expires, since a single packet loss at the tail does not indicate 
persistent congestion. Instead, QUIC collapses the congestion window when persistent congestion 
is declared; see Section 7.6. In doing this, QUIC avoids unnecessary congestion window 
reductions, obviating the need for correcting mechanisms such as Forward RTO-Recovery (F- 
RTO) [RFC5682]. Since QUIC does not collapse the congestion window on a PTO expiration, a QUIC 
sender is not limited from sending more in-flight packets after a PTO expiration if it still has 
available congestion window. This occurs when a sender is application limited and the PTO timer 
expires. This is more aggressive than TCP's RTO mechanism when application limited, but 
identical when not application limited. 


QUIC allows probe packets to temporarily exceed the congestion window whenever the timer 
expires. 


4.8. The Minimum Congestion Window Is Two Packets 


TCP uses a minimum congestion window of one packet. However, loss of that single packet 
means that the sender needs to wait for a PTO to recover (Section 6.2), which can be much longer 
than an RTT. Sending a single ack-eliciting packet also increases the chances of incurring 
additional latency when a receiver delays its acknowledgment. 


QUIC therefore recommends that the minimum congestion window be two packets. While this 
increases network load, it is considered safe since the sender will still reduce its sending rate 
exponentially under persistent congestion (Section 6.2). 
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4.9. Handshake Packets Are Not Special 


TCP treats the loss of SYN or SYN-ACK packet as persistent congestion and reduces the congestion 
window to one packet; see [RFC5681]. QUIC treats loss of a packet containing handshake data the 
same as other losses. 


5. Estimating the Round-Trip Time 


At a high level, an endpoint measures the time from when a packet was sent to when it is 
acknowledged as an RTT sample. The endpoint uses RTT samples and peer-reported host delays 
(see Section 13.2 of [QUIC-TRANSPORT]) to generate a statistical description of the network path's 
RTT. An endpoint computes the following three values for each path: the minimum value over a 
period of time (min_rtt), an exponentially weighted moving average (smoothed_rtt), and the 
mean deviation (referred to as "variation" in the rest of this document) in the observed RTT 
samples (rttvar). 


5.1. Generating RTT Samples 


An endpoint generates an RTT sample on receiving an ACK frame that meets the following two 
conditions: 


e the largest acknowledged packet number is newly acknowledged, and 
e at least one of the newly acknowledged packets was ack-eliciting. 


The RTT sample, latest_rtt, is generated as the time elapsed since the largest acknowledged 
packet was sent: 


latest_rtt = ack_time - send_time_of_largest_acked 


An RTT sample is generated using only the largest acknowledged packet in the received ACK 
frame. This is because a peer reports acknowledgment delays for only the largest acknowledged 
packet in an ACK frame. While the reported acknowledgment delay is not used by the RTT 
sample measurement, it is used to adjust the RTT sample in subsequent computations of 
smoothed_rtt and rttvar (Section 5.3). 


To avoid generating multiple RTT samples for a single packet, an ACK frame SHOULD NOT be used 
to update RTT estimates if it does not newly acknowledge the largest acknowledged packet. 


An RTT sample MUST NOT be generated on receiving an ACK frame that does not newly 
acknowledge at least one ack-eliciting packet. A peer usually does not send an ACK frame when 
only non-ack-eliciting packets are received. Therefore, an ACK frame that contains 
acknowledgments for only non-ack-eliciting packets could include an arbitrarily large ACK Delay 
value. Ignoring such ACK frames avoids complications in subsequent smoothed_rtt and rttvar 
computations. 
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A sender might generate multiple RTT samples per RTT when multiple ACK frames are received 
within an RTT. As suggested in [RFC6298], doing so might result in inadequate history in 
smoothed rtt and rttvar. Ensuring that RTT estimates retain sufficient history is an open 
research question. 


5.2. Estimating min rtt 


min rtt is the sender's estimate of the minimum RTT observed for a given network path over a 
period of time. In this document, min rtt is used by loss detection to reject implausibly small RTT 
samples. 


min rtt MUST be set to the latest rtt on the first RTT sample. min rtt MUST be set to the lesser of 
min rtt and latest rtt (Section 5.1) on all other samples. 


An endpoint uses only locally observed times in computing the min rtt and does not adjust for 
acknowledgment delays reported by the peer. Doing so allows the endpoint to set a lower bound 
for the smoothed rtt based entirely on what it observes (see Section 5.3) and limits potential 
underestimation due to erroneously reported delays by the peer. 


The RTT for a network path may change over time. If a path's actual RTT decreases, the min rtt 
will adapt immediately on the first low sample. If the path's actual RTT increases, however, the 
min_rtt will not adapt to it, allowing future RTT samples that are smaller than the new RTT to be 
included in smoothed rtt. 


Endpoints SHOULD set the min_rtt to the newest RTT sample after persistent congestion is 
established. This avoids repeatedly declaring persistent congestion when the RTT increases. This 
also allows a connection to reset its estimate of min_rtt and smoothed rtt after a disruptive 
network event; see Section 5.3. 


Endpoints MAY reestablish the min_rtt at other times in the connection, such as when traffic 
volume is low and an acknowledgment is received with a low acknowledgment delay. 
Implementations SHOULD NOT refresh the min_rtt value too often since the actual minimum RTT 
of the path is not frequently observable. 


5.3. Estimating smoothed_rtt and rttvar 


smoothed_rtt is an exponentially weighted moving average of an endpoint's RTT samples, and 
rttvar estimates the variation in the RTT samples using a mean variation. 


The calculation of smoothed_rtt uses RTT samples after adjusting them for acknowledgment 
delays. These delays are decoded from the ACK Delay field of ACK frames as described in Section 
19.3 of [QUIC-TRANSPORT]. 


The peer might report acknowledgment delays that are larger than the peer's max_ack_delay 
during the handshake (Section 13.2.1 of [QUIC-TRANSPORT]). To account for this, the endpoint 
SHOULD ignore max_ack_delay until the handshake is confirmed, as defined in Section 4.1.2 of 
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[QUIC-TLS]. When they occur, these large acknowledgment delays are likely to be non-repeating 
and limited to the handshake. The endpoint can therefore use them without limiting them to the 
max ack delay, avoiding unnecessary inflation of the RTT estimate. 


Note that a large acknowledgment delay can result in a substantially inflated smoothed rtt if 
there is an error either in the peer's reporting of the acknowledgment delay or in the endpoint's 
min_rtt estimate. Therefore, prior to handshake confirmation, an endpoint MAY ignore RTT 
samples if adjusting the RTT sample for acknowledgment delay causes the sample to be less than 
the min_rtt. 


After the handshake is confirmed, any acknowledgment delays reported by the peer that are 
greater than the peer's max_ack_delay are attributed to unintentional but potentially repeating 
delays, such as scheduler latency at the peer or loss of previous acknowledgments. Excess delays 
could also be due to a noncompliant receiver. Therefore, these extra delays are considered 
effectively part of path delay and incorporated into the RTT estimate. 


Therefore, when adjusting an RTT sample using peer-reported acknowledgment delays, an 
endpoint: 


e MAY ignore the acknowledgment delay for Initial packets, since these acknowledgments are 
not delayed by the peer (Section 13.2.1 of [QUIC-TRANSPORT]); 


e SHOULD ignore the peer's max_ack_delay until the handshake is confirmed; 


e MUST use the lesser of the acknowledgment delay and the peer's max ack delay after the 
handshake is confirmed; and 


e MUST NOT subtract the acknowledgment delay from the RTT sample if the resulting value is 
smaller than the min rtt. This limits the underestimation of the smoothed_rtt due to a 
misreporting peer. 


Additionally, an endpoint might postpone the processing of acknowledgments when the 
corresponding decryption keys are not immediately available. For example, a client might 
receive an acknowledgment for a 0-RTT packet that it cannot decrypt because 1-RTT packet 
protection keys are not yet available to it. In such cases, an endpoint SHOULD subtract such local 
delays from its RTT sample until the handshake is confirmed. 


Similar to [RFC6298], smoothed_rtt and rttvar are computed as follows. 


An endpoint initializes the RTT estimator during connection establishment and when the 
estimator is reset during connection migration; see Section 9.4 of [QUIC-TRANSPORT]. Before any 
RTT samples are available for a new path or when the estimator is reset, the estimator is 
initialized using the initial RTT; see Section 6.2.2. 


smoothed rtt and rttvar are initialized as follows, where kInitialRtt contains the initial RTT 
value: 


smoothed_rtt = kInitialRtt 
Gutvare = kinitiallRtt 2 
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RTT samples for the network path are recorded in latest rtt; see Section 5.1. On the first RTT 
sample after initialization, the estimator is reset using that sample. This ensures that the 
estimator retains no history of past samples. Packets sent on other paths do not contribute RTT 
samples to the current path, as described in Section 9.4 of [QUIC-TRANSPORT]. 


On the first RTT sample after initialization, smoothed rtt and rttvar are set as follows: 


smoothed rtt = latest rtt 
rttvar = latest rtt / 2 


On subsequent RTT samples, smoothed rtt and rttvar evolve as follows: 


ack delay = decoded acknowledgment delay from ACK frame 
if (handshake confirmed): 

ack delay = min(ack delay, max.ack delay) 
adjusted rtt = latest rtt 
if (latest. rtt >= min rtt + ack delay): 

adjusted_rtt = latest rtt - ack delay 
smoothed rtt = 7/8 * smoothed_rtt + 1/8 * adjusted_rtt 
rttvar sample = abs(smoothed rtt - adjusted rtt) 
rttvar = 3/4 * rttvar + 1/4 * rttvar sample 


6. Loss Detection 


QUIC senders use acknowledgments to detect lost packets and a PTO to ensure acknowledgments 
are received; see Section 6.2. This section provides a description of these algorithms. 


If a packet is lost, the QUIC transport needs to recover from that loss, such as by retransmitting 
the data, sending an updated frame, or discarding the frame. For more information, see Section 
13.3 of [QUIC-TRANSPORT]. 


Loss detection is separate per packet number space, unlike RTT measurement and congestion 
control, because RTT and congestion control are properties of the path, whereas loss detection 
also relies upon key availability. 


6.1. Acknowledgment-Based Detection 


Acknowledgment-based loss detection implements the spirit of TCP's Fast Retransmit [RFC5681], 
Early Retransmit [RFC5827], Forward Acknowledgment [FACK], SACK loss recovery [RFC6675], 
and RACK-TLP [RFC8985]. This section provides an overview of how these algorithms are 
implemented in QUIC. 


A packet is declared lost if it meets all of the following conditions: 


e The packet is unacknowledged, in flight, and was sent prior to an acknowledged packet. 


e The packet was sent kPacketThreshold packets before an acknowledged packet (Section 
6.1.1), or it was sent long enough in the past (Section 6.1.2). 
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The acknowledgment indicates that a packet sent later was delivered, and the packet and time 
thresholds provide some tolerance for packet reordering. 


Spuriously declaring packets as lost leads to unnecessary retransmissions and may result in 
degraded performance due to the actions of the congestion controller upon detecting loss. 
Implementations can detect spurious retransmissions and increase the packet or time reordering 
threshold to reduce future spurious retransmissions and loss events. Implementations with 
adaptive time thresholds MAY choose to start with smaller initial reordering thresholds to 
minimize recovery latency. 


6.1.1. Packet Threshold 


The RECOMMENDED initial value for the packet reordering threshold (kPacketThreshold) is 3, 
based on best practices for TCP loss detection [RFC5681] [RFC6675]. In order to remain similar to 
TCP, implementations SHOULD NOT use a packet threshold less than 3; see [RFC5681]. 


Some networks may exhibit higher degrees of packet reordering, causing a sender to detect 
spurious losses. Additionally, packet reordering could be more common with QUIC than TCP 
because network elements that could observe and reorder TCP packets cannot do that for QUIC 
and also because QUIC packet numbers are encrypted. Algorithms that increase the reordering 
threshold after spuriously detecting losses, such as RACK [RFC8985], have proven to be useful in 
TCP and are expected to be at least as useful in QUIC. 


6.1.2. Time Threshold 


Once a later packet within the same packet number space has been acknowledged, an endpoint 
SHOULD declare an earlier packet lost if it was sent a threshold amount of time in the past. To 
avoid declaring packets as lost too early, this time threshold MUST be set to at least the local timer 
granularity, as indicated by the kGranularity constant. The time threshold is: 


max(kTimeThreshold * max(smoothed_rtt, latest_rtt), kGranularity) 
If packets sent prior to the largest acknowledged packet cannot yet be declared lost, then a timer 
SHOULD be set for the remaining time. 


Using max(smoothed_rtt, latest_rtt) protects from the two following cases: 


e the latest RTT sample is lower than the smoothed RTT, perhaps due to reordering where the 
acknowledgment encountered a shorter path; 


e the latest RTT sample is higher than the smoothed RTT, perhaps due to a sustained increase 
in the actual RTT, but the smoothed RTT has not yet caught up. 


The RECOMMENDED time threshold (kTimeThreshold), expressed as an RTT multiplier, is 9/8. The 
RECOMMENDED value of the timer granularity (KGranularity) is 1 millisecond. 


Note: TCP's RACK [RFC8985] specifies a slightly larger threshold, equivalent to 5/4, 
for a similar purpose. Experience with QUIC shows that 9/8 works well. 
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Implementations MAY experiment with absolute thresholds, thresholds from previous 
connections, adaptive thresholds, or the including of RTT variation. Smaller thresholds reduce 
reordering resilience and increase spurious retransmissions, and larger thresholds increase loss 
detection delay. 


6.2. Probe Timeout 


A Probe Timeout (PTO) triggers the sending of one or two probe datagrams when ack-eliciting 
packets are not acknowledged within the expected period of time or the server may not have 
validated the client's address. A PTO enables a connection to recover from loss of tail packets or 
acknowledgments. 


As with loss detection, the PTO is per packet number space. That is, a PTO value is computed per 
packet number space. 


A PTO timer expiration event does not indicate packet loss and MUST NOT cause prior 
unacknowledged packets to be marked as lost. When an acknowledgment is received that newly 
acknowledges packets, loss detection proceeds as dictated by the packet and time threshold 
mechanisms; see Section 6.1. 


The PTO algorithm used in QUIC implements the reliability functions of Tail Loss Probe 
[RFC8985], RTO [RFC5681], and F-RTO algorithms for TCP [RFC5682]. The timeout computation is 
based on TCP's RTO period [RFC6298]. 


6.2.1. Computing PTO 


When an ack-eliciting packet is transmitted, the sender schedules a timer for the PTO period as 
follows: 


PTO = smoothed_rtt + max(4*rttvar, kGranularity) + max_ack_delay 


The PTO period is the amount of time that a sender ought to wait for an acknowledgment of a 
sent packet. This time period includes the estimated network RTT (smoothed_rtt), the variation in 
the estimate (4*rttvar), and max_ack_delay, to account for the maximum time by which a 
receiver might delay sending an acknowledgment. 


When the PTO is armed for Initial or Handshake packet number spaces, the max_ack_delay in 
the PTO period computation is set to 0, since the peer is expected to not delay these packets 
intentionally; see Section 13.2.1 of [QUIC-TRANSPORT]. 


The PTO period MUST be at least kGranularity to avoid the timer expiring immediately. 


When ack-eliciting packets in multiple packet number spaces are in flight, the timer MUST be set 
to the earlier value of the Initial and Handshake packet number spaces. 


An endpoint MUST NOT set its PTO timer for the Application Data packet number space until the 
handshake is confirmed. Doing so prevents the endpoint from retransmitting information in 
packets when either the peer does not yet have the keys to process them or the endpoint does not 
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yet have the keys to process their acknowledgments. For example, this can happen when a client 
sends 0-RTT packets to the server; it does so without knowing whether the server will be able to 
decrypt them. Similarly, this can happen when a server sends 1-RTT packets before confirming 
that the client has verified the server's certificate and can therefore read these 1-RTT packets. 


A sender SHOULD restart its PTO timer every time an ack-eliciting packet is sent or 
acknowledged, or when Initial or Handshake keys are discarded (Section 4.9 of [QUIC-TLSJ). This 
ensures the PTO is always set based on the latest estimate of the RTT and for the correct packet 
across packet number spaces. 


When a PTO timer expires, the PTO backoff MUST be increased, resulting in the PTO period being 
set to twice its current value. The PTO backoff factor is reset when an acknowledgment is 
received, except in the following case. A server might take longer to respond to packets during 
the handshake than otherwise. To protect such a server from repeated client probes, the PTO 
backoff is not reset at a client that is not yet certain that the server has finished validating the 
client's address. That is, a client does not reset the PTO backoff factor on receiving 
acknowledgments in Initial packets. 


This exponential reduction in the sender's rate is important because consecutive PTOs might be 
caused by loss of packets or acknowledgments due to severe congestion. Even when there are 
ack-eliciting packets in flight in multiple packet number spaces, the exponential increase in PTO 
occurs across all spaces to prevent excess load on the network. For example, a timeout in the 
Initial packet number space doubles the length of the timeout in the Handshake packet number 
space. 


The total length of time over which consecutive PTOs expire is limited by the idle timeout. 


The PTO timer MUST NOT be set if a timer is set for time threshold loss detection; see Section 
6.1.2. A timer that is set for time threshold loss detection will expire earlier than the PTO timer in 
most cases and is less likely to spuriously retransmit data. 


6.2.2. Handshakes and New Paths 


Resumed connections over the same network MAY use the previous connection's final smoothed 
RTT value as the resumed connection's initial RTT. When no previous RTT is available, the initial 
RTT SHOULD be set to 333 milliseconds. This results in handshakes starting with a PTO of 1 
second, as recommended for TCP's initial RTO; see Section 2 of [RFC6298]. 


A connection MAY use the delay between sending a PATH_CHALLENGE and receiving a 
PATH RESPONSE to set the initial RTT (see kInitialRtt in Appendix A.2) for a new path, but the 
delay SHOULD NOT be considered an RTT sample. 


When the Initial keys and Handshake keys are discarded (see Section 6.4), any Initial packets and 
Handshake packets can no longer be acknowledged, so they are removed from bytes in flight. 
When Initial or Handshake keys are discarded, the PTO and loss detection timers MUST be reset, 
because discarding keys indicates forward progress and the loss detection timer might have been 
set for a now-discarded packet number space. 
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6.2.2.1. Before Address Validation 


Until the server has validated the client's address on the path, the amount of data it can send is 
limited to three times the amount of data received, as specified in Section 8.1 of [QUIC- 
TRANSPORTI. If no additional data can be sent, the server's PTO timer MUST NOT be armed until 
datagrams have been received from the client because packets sent on PTO count against the 
anti-amplification limit. 


When the server receives a datagram from the client, the amplification limit is increased and the 
server resets the PTO timer. If the PTO timer is then set to a time in the past, it is executed 
immediately. Doing so avoids sending new 1-RTT packets prior to packets critical to the 
completion of the handshake. In particular, this can happen when 0-RTT is accepted but the 
server fails to validate the client's address. 


Since the server could be blocked until more datagrams are received from the client, it is the 
client's responsibility to send packets to unblock the server until it is certain that the server has 
finished its address validation (see Section 8 of [QUIC-TRANSPORT]). That is, the client MUST set 
the PTO timer if the client has not received an acknowledgment for any of its Handshake packets 
and the handshake is not confirmed (see Section 4.1.2 of [QUIC-TLS]), even if there are no packets 
in flight. When the PTO fires, the client MUST send a Handshake packet if it has Handshake keys, 
otherwise it MUST send an Initial packet in a UDP datagram with a payload of at least 1200 bytes. 


6.2.3. Speeding up Handshake Completion 


When a server receives an Initial packet containing duplicate CRYPTO data, it can assume the 
client did not receive all of the server's CRYPTO data sent in Initial packets, or the client's 
estimated RTT is too small. When a client receives Handshake or 1-RTT packets prior to obtaining 
Handshake keys, it may assume some or all of the server's Initial packets were lost. 


To speed up handshake completion under these conditions, an endpoint MAY, for a limited 
number of times per connection, send a packet containing unacknowledged CRYPTO data earlier 
than the PTO expiry, subject to the address validation limits in Section 8.1 of [QUIC-TRANSPORT]. 
Doing so at most once for each connection is adequate to quickly recover from a single packet 
loss. An endpoint that always retransmits packets in response to receiving packets that it cannot 
process risks creating an infinite exchange of packets. 


Endpoints can also use coalesced packets (see Section 12.2 of [QUIC-TRANSPORT]) to ensure that 
each datagram elicits at least one acknowledgment. For example, a client can coalesce an Initial 
packet containing PING and PADDING frames with a 0-RTT data packet, and a server can coalesce 
an Initial packet containing a PING frame with one or more packets in its first flight. 


6.2.4. Sending Probe Packets 


When a PTO timer expires, a sender MUST send at least one ack-eliciting packet in the packet 
number space as a probe. An endpoint MAY send up to two full-sized datagrams containing ack- 
eliciting packets to avoid an expensive consecutive PTO expiration due to a single lost datagram 
or to transmit data from multiple packet number spaces. All probe packets sent on a PTO MUST 
be ack-eliciting. 
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In addition to sending data in the packet number space for which the timer expired, the sender 
SHOULD send ack-eliciting packets from other packet number spaces with in-flight data, 
coalescing packets if possible. This is particularly valuable when the server has both Initial and 
Handshake data in flight or when the client has both Handshake and Application Data in flight 
because the peer might only have receive keys for one of the two packet number spaces. 


If the sender wants to elicit a faster acknowledgment on PTO, it can skip a packet number to 
eliminate the acknowledgment delay. 


An endpoint SHOULD include new data in packets that are sent on PTO expiration. Previously 
sent data MAY be sent if no new data can be sent. Implementations MAY use alternative strategies 
for determining the content of probe packets, including sending new or retransmitted data based 
on the application's priorities. 


It is possible the sender has no new or previously sent data to send. As an example, consider the 
following sequence of events: new application data is sent in a STREAM frame, deemed lost, then 
retransmitted in a new packet, and then the original transmission is acknowledged. When there 
is no data to send, the sender SHOULD send a PING or other ack-eliciting frame in a single packet, 
rearming the PTO timer. 


Alternatively, instead of sending an ack-eliciting packet, the sender MAY mark any packets still in 
flight as lost. Doing so avoids sending an additional packet but increases the risk that loss is 
declared too aggressively, resulting in an unnecessary rate reduction by the congestion 
controller. 


Consecutive PTO periods increase exponentially, and as a result, connection recovery latency 
increases exponentially as packets continue to be dropped in the network. Sending two packets 
on PTO expiration increases resilience to packet drops, thus reducing the probability of 
consecutive PTO events. 


When the PTO timer expires multiple times and new data cannot be sent, implementations must 
choose between sending the same payload every time or sending different payloads. Sending the 
same payload may be simpler and ensures the highest priority frames arrive first. Sending 
different payloads each time reduces the chances of spurious retransmission. 


6.3. Handling Retry Packets 


A Retry packet causes a client to send another Initial packet, effectively restarting the connection 
process. A Retry packet indicates that the Initial packet was received but not processed. A Retry 
packet cannot be treated as an acknowledgment because it does not indicate that a packet was 
processed or specify the packet number. 


Clients that receive a Retry packet reset congestion control and loss recovery state, including 
resetting any pending timers. Other connection state, in particular cryptographic handshake 
messages, is retained; see Section 17.2.5 of [QUIC-TRANSPORT]. 
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The client MAY compute an RTT estimate to the server as the time period from when the first 
Initial packet was sent to when a Retry or a Version Negotiation packet is received. The client 
MAY use this value in place of its default for the initial RTT estimate. 


6.4. Discarding Keys and Packet State 


When Initial and Handshake packet protection keys are discarded (see Section 4.9 of [QUIC-TLS]), 
all packets that were sent with those keys can no longer be acknowledged because their 
acknowledgments cannot be processed. The sender MUST discard all recovery state associated 
with those packets and MUST remove them from the count of bytes in flight. 


Endpoints stop sending and receiving Initial packets once they start exchanging Handshake 
packets; see Section 17.2.2.1 of [QUIC-TRANSPORT]. At this point, recovery state for all in-flight 
Initial packets is discarded. 


When 0-RTT is rejected, recovery state for all in-flight 0-RTT packets is discarded. 


If a server accepts 0-RTT, but does not buffer 0-RTT packets that arrive before Initial packets, 
early 0-RTT packets will be declared lost, but that is expected to be infrequent. 


It is expected that keys are discarded at some time after the packets encrypted with them are 
either acknowledged or declared lost. However, Initial and Handshake secrets are discarded as 
soon as Handshake and 1-RTT keys are proven to be available to both client and server; see 
Section 4.9.1 of [QUIC-TLS]. 


7. Congestion Control 


This document specifies a sender-side congestion controller for QUIC similar to TCP NewReno 
[RFC6582]. 


The signals QUIC provides for congestion control are generic and are designed to support 
different sender-side algorithms. A sender can unilaterally choose a different algorithm to use, 
such as CUBIC [RFC8312]. 


If a sender uses a different controller than that specified in this document, the chosen controller 
MUST conform to the congestion control guidelines specified in Section 3.1 of [RFC8085]. 


Similar to TCP, packets containing only ACK frames do not count toward bytes in flight and are 
not congestion controlled. Unlike TCP, QUIC can detect the loss of these packets and MAY use that 
information to adjust the congestion controller or the rate of ACK-only packets being sent, but 
this document does not describe a mechanism for doing so. 


The congestion controller is per path, so packets sent on other paths do not alter the current 
path's congestion controller, as described in Section 9.4 of [QUIC-TRANSPORT]. 


The algorithm in this document specifies and uses the controller's congestion window in bytes. 
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An endpoint MUST NOT send a packet if it would cause bytes in flight (see Appendix B.2) to be 
larger than the congestion window, unless the packet is sent on a PTO timer expiration (see 
Section 6.2) or when entering recovery (see Section 7.3.2). 


7.1. Explicit Congestion Notification 


If a path has been validated to support Explicit Congestion Notification (ECN) [RFC3168] 
[RFC8311], QUIC treats a Congestion Experienced (CE) codepoint in the IP header as a signal of 
congestion. This document specifies an endpoint's response when the peer-reported ECN-CE 
count increases; see Section 13.4.2 of [QUIC-TRANSPORT]. 


7.2. Initial and Minimum Congestion Window 


QUIC begins every connection in slow start with the congestion window set to an initial value. 
Endpoints SHOULD use an initial congestion window of ten times the maximum datagram size 
(max_datagram_size), while limiting the window to the larger of 14,720 bytes or twice the 
maximum datagram size. This follows the analysis and recommendations in [RFC6928], 
increasing the byte limit to account for the smaller 8-byte overhead of UDP compared to the 20- 
byte overhead for TCP. 


If the maximum datagram size changes during the connection, the initial congestion window 
SHOULD be recalculated with the new size. If the maximum datagram size is decreased in order 
to complete the handshake, the congestion window SHOULD be set to the new initial congestion 
window. 


Prior to validating the client's address, the server can be further limited by the anti-amplification 
limit as specified in Section 8.1 of [QUIC-TRANSPORT]. Though the anti-amplification limit can 
prevent the congestion window from being fully utilized and therefore slow down the increase 
in congestion window, it does not directly affect the congestion window. 


The minimum congestion window is the smallest value the congestion window can attain in 
response to loss, an increase in the peer-reported ECN-CE count, or persistent congestion. The 
RECOMMENDED value is 2 * max_datagram_size. 


7.3. Congestion Control States 


The NewReno congestion controller described in this document has three distinct states, as 
shown in Figure 1. 
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Figure 1: Congestion Control States and Transitions 
These states and the transitions between them are described in subsequent sections. 


7.3.1. Slow Start 


A NewReno sender is in slow start any time the congestion window is below the slow start 
threshold. A sender begins in slow start because the slow start threshold is initialized to an 
infinite value. 


While a sender is in slow start, the congestion window increases by the number of bytes 
acknowledged when each acknowledgment is processed. This results in exponential growth of 
the congestion window. 


The sender MUST exit slow start and enter a recovery period when a packet is lost or when the 
ECN-CE count reported by its peer increases. 


A sender reenters slow start any time the congestion window is less than the slow start 
threshold, which only occurs after persistent congestion is declared. 


7.3.2. Recovery 


A NewReno sender enters a recovery period when it detects the loss of a packet or when the ECN- 
CE count reported by its peer increases. A sender that is already in a recovery period stays in it 
and does not reenter it. 


On entering a recovery period, a sender MUST set the slow start threshold to half the value of the 
congestion window when loss is detected. The congestion window MUST be set to the reduced 
value of the slow start threshold before exiting the recovery period. 
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Implementations MAY reduce the congestion window immediately upon entering a recovery 
period or use other mechanisms, such as Proportional Rate Reduction [PRR], to reduce the 
congestion window more gradually. If the congestion window is reduced immediately, a single 
packet can be sent prior to reduction. This speeds up loss recovery if the data in the lost packet is 
retransmitted and is similar to TCP as described in Section 5 of [RFC6675]. 


The recovery period aims to limit congestion window reduction to once per round trip. 
Therefore, during a recovery period, the congestion window does not change in response to new 
losses or increases in the ECN-CE count. 


A recovery period ends and the sender enters congestion avoidance when a packet sent during 
the recovery period is acknowledged. This is slightly different from TCP's definition of recovery, 
which ends when the lost segment that started recovery is acknowledged [RFC5681]. 


7.3.3. Congestion Avoidance 


A NewReno sender is in congestion avoidance any time the congestion window is at or above the 
slow start threshold and not in a recovery period. 


A sender in congestion avoidance uses an Additive Increase Multiplicative Decrease (AIMD) 
approach that MUST limit the increase to the congestion window to at most one maximum 
datagram size for each congestion window that is acknowledged. 


The sender exits congestion avoidance and enters a recovery period when a packet is lost or 
when the ECN-CE count reported by its peer increases. 


7.4. Ignoring Loss of Undecryptable Packets 


During the handshake, some packet protection keys might not be available when a packet 
arrives, and the receiver can choose to drop the packet. In particular, Handshake and 0-RTT 
packets cannot be processed until the Initial packets arrive, and 1-RTT packets cannot be 
processed until the handshake completes. Endpoints MAY ignore the loss of Handshake, 0-RTT, 
and 1-RTT packets that might have arrived before the peer had packet protection keys to process 
those packets. Endpoints MUST NOT ignore the loss of packets that were sent after the earliest 
acknowledged packet in a given packet number space. 


7.5. Probe Timeout 


Probe packets MUST NOT be blocked by the congestion controller. A sender MUST however count 
these packets as being additionally in flight, since these packets add network load without 
establishing packet loss. Note that sending probe packets might cause the sender's bytes in flight 
to exceed the congestion window until an acknowledgment is received that establishes loss or 
delivery of packets. 


7.6. Persistent Congestion 


When a sender establishes loss of all packets sent over a long enough duration, the network is 
considered to be experiencing persistent congestion. 
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7.6.1. Duration 


The persistent congestion duration is computed as follows: 


(smoothed_rtt + max(4*rttvar, kGranularity) + max.ack delay) * 
kPersistentCongestionThreshold 


Unlike the PTO computation in Section 6.2, this duration includes the max ack delay irrespective 
of the packet number spaces in which losses are established. 


This duration allows a sender to send as many packets before establishing persistent congestion, 
including some in response to PTO expiration, as TCP does with Tail Loss Probes [RFC8985] and 
an RTO [RFC5681]. 


Larger values of kPersistentCongestionThreshold cause the sender to become less responsive to 
persistent congestion in the network, which can result in aggressive sending into a congested 
network. Too small a value can result in a sender declaring persistent congestion unnecessarily, 
resulting in reduced throughput for the sender. 


The RECOMMENDED value for kPersistentCongestionThreshold is 3, which results in behavior 
that is approximately equivalent to a TCP sender declaring an RTO after two TLPs. 


This design does not use consecutive PTO events to establish persistent congestion, since 
application patterns impact PTO expiration. For example, a sender that sends small amounts of 
data with silence periods between them restarts the PTO timer every time it sends, potentially 
preventing the PTO timer from expiring for a long period of time, even when no 
acknowledgments are being received. The use of a duration enables a sender to establish 
persistent congestion without depending on PTO expiration. 


7.6.2. Establishing Persistent Congestion 


A sender establishes persistent congestion after the receipt of an acknowledgment if two packets 
that are ack-eliciting are declared lost, and: 


* across all packet number spaces, none of the packets sent between the send times of these 
two packets are acknowledged; 


e the duration between the send times of these two packets exceeds the persistent congestion 
duration (Section 7.6.1); and 


e a prior RTT sample existed when these two packets were sent. 


These two packets MUST be ack-eliciting, since a receiver is required to acknowledge only ack- 
eliciting packets within its maximum acknowledgment delay; see Section 13.2 of [QUIC- 
TRANSPORT]. 
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The persistent congestion period SHOULD NOT start until there is at least one RTT sample. Before 
the first RTT sample, a sender arms its PTO timer based on the initial RTT (Section 6.2.2), which 
could be substantially larger than the actual RTT. Requiring a prior RTT sample prevents a 
sender from establishing persistent congestion with potentially too few probes. 


Since network congestion is not affected by packet number spaces, persistent congestion SHOULD 
consider packets sent across packet number spaces. A sender that does not have state for all 
packet number spaces or an implementation that cannot compare send times across packet 
number spaces MAY use state for just the packet number space that was acknowledged. This 
might result in erroneously declaring persistent congestion, but it will not lead to a failure to 
detect persistent congestion. 


When persistent congestion is declared, the sender's congestion window MUST be reduced to the 
minimum congestion window (kMinimumWindow), similar to a TCP sender's response on an 
RTO [RFC5681]. 


7.6.3. Example 


The following example illustrates how a sender might establish persistent congestion. Assume: 


smoothed_rtt + max(4*rttvar, kGranularity) + max_ack_delay = 2 
kPersistentCongestionThreshold = 3 


Consider the following sequence of events: 


Time Action 
t=0 Send packet #1 (application data) 
t=1 Send packet #2 (application data) 


t=1.2 Receive acknowledgment of #1 


t=2 Send packet #3 (application data) 
t=3 Send packet #4 (application data) 
t=4 Send packet #5 (application data) 
t=5 Send packet #6 (application data) 
t=6 Send packet #7 (application data) 


t=8 Send packet #8 (PTO 1) 


t=12 Send packet #9 (PTO 2) 
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Time Action 


t=12.2 Receive acknowledgment of #9 
Table 1 


Packets 2 through 8 are declared lost when the acknowledgment for packet 9 is received at t = 
ye. 


The congestion period is calculated as the time between the oldest and newest lost packets: 8 - 1 
= 7. The persistent congestion duration is2 * 3 = 6. Because the threshold was reached and 
because none of the packets between the oldest and the newest lost packets were acknowledged, 
the network is considered to have experienced persistent congestion. 


While this example shows PTO expiration, they are not required for persistent congestion to be 
established. 


7.7. Pacing 


A sender SHOULD pace sending of all in-flight packets based on input from the congestion 
controller. 


Sending multiple packets into the network without any delay between them creates a packet 
burst that might cause short-term congestion and losses. Senders MUST either use pacing or limit 
such bursts. Senders SHOULD limit bursts to the initial congestion window; see Section 7.2. A 
sender with knowledge that the network path to the receiver can absorb larger bursts MAY use a 
higher limit. 


An implementation should take care to architect its congestion controller to work well with a 
pacer. For instance, a pacer might wrap the congestion controller and control the availability of 
the congestion window, or a pacer might pace out packets handed to it by the congestion 
controller. 


Timely delivery of ACK frames is important for efficient loss recovery. To avoid delaying their 
delivery to the peer, packets containing only ACK frames SHOULD therefore not be paced. 


Endpoints can implement pacing as they choose. A perfectly paced sender spreads packets 
exactly evenly over time. For a window-based congestion controller, such as the one in this 
document, that rate can be computed by averaging the congestion window over the RTT. 
Expressed as a rate in units of bytes per time, where congestion_window is in bytes: 


rate = N * congestion_window / smoothed_rtt 
Or expressed as an inter-packet interval in units of time: 


interval = ( smoothed_rtt * packet_size / congestion_window ) / N 
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Using a value for N that is small, but at least 1 (for example, 1.25) ensures that variations in RTT 
do not result in underutilization of the congestion window. 


Practical considerations, such as packetization, scheduling delays, and computational efficiency, 
can cause a sender to deviate from this rate over time periods that are much shorter than an RTT. 


One possible implementation strategy for pacing uses a leaky bucket algorithm, where the 
capacity of the "bucket" is limited to the maximum burst size and the rate the "bucket" fills is 
determined by the above function. 


7.8. Underutilizing the Congestion Window 


When bytes in flight is smaller than the congestion window and sending is not pacing limited, the 
congestion window is underutilized. This can happen due to insufficient application data or flow 
control limits. When this occurs, the congestion window SHOULD NOT be increased in either slow 
start or congestion avoidance. 


A sender that paces packets (see Section 7.7) might delay sending packets and not fully utilize the 
congestion window due to this delay. A sender SHOULD NOT consider itself application limited if 
it would have fully utilized the congestion window without pacing delay. 


A sender MAY implement alternative mechanisms to update its congestion window after periods 
of underutilization, such as those proposed for TCP in [RFC7661]. 


8. Security Considerations 


8.1. Loss and Congestion Signals 


Loss detection and congestion control fundamentally involve the consumption of signals, such as 
delay, loss, and ECN markings, from unauthenticated entities. An attacker can cause endpoints to 
reduce their sending rate by manipulating these signals: by dropping packets, by altering path 
delay strategically, or by changing ECN codepoints. 


8.2. Traffic Analysis 


Packets that carry only ACK frames can be heuristically identified by observing packet size. 
Acknowledgment patterns may expose information about link characteristics or application 
behavior. To reduce leaked information, endpoints can bundle acknowledgments with other 
frames, or they can use PADDING frames at a potential cost to performance. 


8.3. Misreporting ECN Markings 


A receiver can misreport ECN markings to alter the congestion response of a sender. Suppressing 
reports of ECN-CE markings could cause a sender to increase their send rate. This increase could 
result in congestion and loss. 
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A sender can detect suppression of reports by marking occasional packets that it sends with an 
ECN-CE marking. If a packet sent with an ECN-CE marking is not reported as having been CE 
marked when the packet is acknowledged, then the sender can disable ECN for that path by not 
setting ECN-Capable Transport (ECT) codepoints in subsequent packets sent on that path 
[RFC3168]. 


Reporting additional ECN-CE markings will cause a sender to reduce their sending rate, which is 
similar in effect to advertising reduced connection flow control limits and so no advantage is 
gained by doing so. 


Endpoints choose the congestion controller that they use. Congestion controllers respond to 
reports of ECN-CE by reducing their rate, but the response may vary. Markings can be treated as 
equivalent to loss [RFC3168], but other responses can be specified, such as [RFC8511] or 
[RFC8311]. 
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Appendix A. Loss Recovery Pseudocode 


We now describe an example implementation of the loss detection mechanisms described in 
Section 6. 


The pseudocode segments in this section are licensed as Code Components; see the copyright 
notice. 


A.1. Tracking Sent Packets 


To correctly implement congestion control, a QUIC sender tracks every ack-eliciting packet until 
the packet is acknowledged or lost. It is expected that implementations will be able to access this 
information by packet number and crypto context and store the per-packet fields (Appendix 
A.1.1) for loss recovery and congestion control. 


After a packet is declared lost, the endpoint can still maintain state for it for an amount of time to 
allow for packet reordering; see Section 13.3 of [QUIC-TRANSPORT]. This enables a sender to 
detect spurious retransmissions. 


Sent packets are tracked for each packet number space, and ACK processing only applies to a 
single space. 


A.1.1. Sent Packet Fields 


packet_number: The packet number of the sent packet. 


ack_eliciting: A Boolean that indicates whether a packet is ack-eliciting. If true, it is expected 
that an acknowledgment will be received, though the peer could delay sending the ACK frame 
containing it by up to the max_ack_delay. 


in_flight: A Boolean that indicates whether the packet counts toward bytes in flight. 
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sent bytes: The number of bytes sent in the packet, not including UDP or IP overhead, but 
including QUIC framing overhead. 


time sent: The time the packet was sent. 


A.2. Constants of Interest 


Constants used in loss recovery are based on a combination of RFCs, papers, and common 
practice. 


kPacketThreshold: Maximum reordering in packets before packet threshold loss detection 
considers a packet lost. The value recommended in Section 6.1.1 is 3. 


kTimeThreshold: Maximum reordering in time before time threshold loss detection considers a 
packet lost. Specified as an RTT multiplier. The value recommended in Section 6.1.2 is 9/8. 


kGranularity: Timer granularity. This is a system-dependent value, and Section 6.1.2 
recommends a value of 1 ms. 


kInitialRtt: The RTT used before an RTT sample is taken. The value recommended in Section 
6.2.2 is 333 ms. 


kPacketNumberSpace: An enum to enumerate the three packet number spaces: 


enum kPacketNumberSpace { 
Initial, 
Handshake, 
ApplicationData, 


A.3. Variables of Interest 


Variables required to implement the congestion control mechanisms are described in this 
section. 


latest_rtt: The most recent RTT measurement made when receiving an acknowledgment for a 
previously unacknowledged packet. 

smoothed_rtt: The smoothed RTT of the connection, computed as described in Section 5.3. 

rttvar: The RTT variation, computed as described in Section 5.3. 


min rtt: The minimum RTT seen over a period of time, ignoring acknowledgment delay, as 
described in Section 5.2. 


first_rtt_sample: The time that the first RTT sample was obtained. 
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max ack delay: The maximum amount of time by which the receiver intends to delay 
acknowledgments for packets in the Application Data packet number space, as defined by the 
eponymous transport parameter (Section 18.2 of [QUIC-TRANSPORT]). Note that the actual 
ack delay in a received ACK frame may be larger due to late timers, reordering, or loss. 


loss detection timer: Multi-modal timer used for loss detection. 
pto count: The number of times a PTO has been sent without receiving an acknowledgment. 


time of last ack eliciting packet[kPacketNumberSpace]: The time the most recent ack-eliciting 
packet was sent. 


largest acked packet[kPacketNumberSpace]: The largest packet number acknowledged in the 
packet number space so far. 


loss time[kPacketNumberSpace]: The time at which the next packet in that packet number 
space can be considered lost based on exceeding the reordering window in time. 


sent packets[kPacketNumberSpace]: An association of packet numbers in a packet number 
space to information about them. Described in detail above in Appendix A.1. 


A.4. Initialization 


At the beginning of the connection, initialize the loss detection variables as follows: 


loss detection timer.reset() 

pto count = @ 

latest. rtt = 9 

smoothed_rtt = kInitialRtt 

rttvar = kInitialRtt / 2 

min_rtt = @ 

first_rtt_sample = 9 

for pn_space in [ Initial, Handshake, ApplicationData ]: 
largest_acked_packet[pn_space] = infinite 
time of last ack eliciting packet[pn space] = 9 
loss time[pn space] = @ 


A.5. On Sending a Packet 


After a packet is sent, information about the packet is stored. The parameters to OnPacketSent 
are described in detail above in Appendix A.1.1. 
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Pseudocode for OnPacketSent follows: 


OnPacketSent(packet number, pn space, ack eliciting, 
in flight, sent bytes): 
sent packets[pn space] [packet number] .packet number = 
packet number 
sent. packets[pn space] [packet number].time. sent = now() 
sent. packets[pn space] [packet number] .ack eliciting = 
ack eliciting 
sent packets[pn space] [packet number] .in flight = in flight 
sent packets[pn space] [packet number] .sent bytes = sent bytes 
if (Gnerlight): 
if (ack eliciting): 
time of last. ack eliciting packet[pn space] = now() 
OnPacketSentCC(sent bytes) 
SetLossDetectionTimer() 


A.6. On Receiving a Datagram 


When a server is blocked by anti-amplification limits, receiving a datagram unblocks it, even if 
none of the packets in the datagram are successfully processed. In such a case, the PTO timer will 
need to be rearmed. 


Pseudocode for OnDatagramReceived follows: 


OnDatagramReceived(datagram) : 
// If this datagram unblocks the server, arm the 
// PTO timer to avoid deadlock. 
if (server was at anti-amplification limit): 
SetLossDetectionTimer () 
if loss_detection_timer.timeout < now(): 
// Execute PTO if it would have expired 
// while the amplification limit applied. 
OnLossDetectionTimeout () 


A.7. On Receiving an Acknowledgment 


When an ACK frame is received, it may newly acknowledge any number of packets. 
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Pseudocode for OnAckReceived and UpdateRtt follow: 
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IncludesAckEliciting(packets) : 


for packet in packets: 
if (packet.ack_eliciting) : 
return true 
return false 


OnAckReceived(ack, pn. space): 


if (largest. acked packet[pn space] == infinite): 
largest acked packet[pn space] = ack.largest acked 
else: 
largest acked packet[pn space] = 


max(largest acked packet[pn. space], ack.largest acked) 


// DetectAndRemoveAckedPackets finds packets that are newly 


// acknowledged and removes them from sent_packets. 
newly_acked_packets = 
DetectAndRemoveAckedPackets(ack, pn_space) 


// Nothing to do if there are no newly acked packets. 


if (newly_acked_packets.empty()): 
return 


// Update the RTT if the largest acknowledged is newly acked 


// and at least one ack-eliciting was newly acked. 
if (newly_acked_packets.largest().packet_number == 
ack.largest acked && 
IncludesAckEliciting(newly acked packets)): 
latest. rtt = 
now() - newly.acked packets.largest().time. sent 
UpdateRtt(ack.ack delay) 


// Process ECN information if present. 
if (ACK frame contains ECN information): 
ProcessECN(ack, pn. space) 


lost packets = DetectAndRemoveLostPackets(pn space) 

if (!lost_packets.empty()): 
OnPacketsLost(lost_packets) 

OnPacketsAcked(newly_acked_packets) 


// Reset pto_count unless the client is unsure if 
// the server has validated the client's address. 
if (PeerCompletedAddressValidation()): 

pto_count = @ 
SetLossDetectionTimer() 


UpdateRtt(ack delay): 


if (first_rtt_sample == 9): 
min rtt = latest rtt 
smoothed rtt = latest rtt 
rttvar = latest rtt / 2 
first rtt sample = now() 
return 


// min_rtt ignores acknowledgment delay. 
min_rtt = min(min_rtt, latest_rtt) 
// Limit ack_delay by max_ack_delay after handshake 
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// confirmation. 
if (handshake confirmed): 
ack delay = min(ack delay, max.ack delay) 


// Adjust for acknowledgment delay if plausible. 

adjusted rtt = latest rtt 

if (latest rtt >= min rtt + ack delay): 
adjusted rtt = latest rtt - ack delay 


rttvar = 3/4 * rttvar + 1/4 * abs(smoothed rtt - adjusted rtt) 
smoothed_rtt = 7/8 * smoothed rtt + 1/8 * adjusted rtt 


A.8. Setting the Loss Detection Timer 


QUIC loss detection uses a single timer for all timeout loss detection. The duration of the timer is 
based on the timer's mode, which is set in the packet and timer events further below. The 
function SetLossDetectionTimer defined below shows how the single timer is set. 


This algorithm may result in the timer being set in the past, particularly if timers wake up late. 
Timers set in the past fire immediately. 
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Pseudocode for SetLossDetectionTimer follows (where the "4" operator represents 
exponentiation): 
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GetLossTimeAndSpace(): 
time = loss time[Initial] 
space = Initial 
for pn. space in [ Handshake, ApplicationData |: 
if (time == || loss time[pn space] < time): 
time = loss time[pn space]; 
space = pn space 
return time, space 


GetPtoTimeAndSpace(): 
duration = (smoothed_rtt + max(4 * rttvar, kGranularity) ) 
* (2 * pto_count) 
// Anti-deadlock PTO starts from the current time 
if (no ack-eliciting packets in flight): 
assert(!PeerCompletedAddressValidation() ) 
if (has handshake keys): 
return (now() + duration), Handshake 
else: 
return (now() + duration), Initial 
pto_timeout = infinite 
pto_space = Initial 
for space in [ Initial, Handshake, ApplicationData ]: 
if (no ack-eliciting packets in flight in space): 
continue; 
if (space == ApplicationData) : 
// Skip Application Data until handshake confirmed. 
if (handshake is not confirmed): 
return pto_timeout, pto_space 
// Include max_ack_delay and backoff for Application Data. 
duration += max_ack_delay * (2 ^ pto_count) 


t = time of last. ack eliciting packet[space] + duration 
if (t < pto timeout): 
pto timeout = t 
pto. space = space 
return pto timeout, pto space 


PeerCompletedAddressValidation(): 
// Assume clients validate the server's address implicitly. 
if (endpoint is server): 
return true 
// Servers complete address validation when a 
// protected packet is received. 
return has received Handshake ACK | | 
handshake confirmed 


SetLossDetectionTimer(): 
earliest loss time, _ = GetLossTimeAndSpace() 
if (earliest. loss time != @): 
// Time threshold loss detection. 
loss detection timer.update(earliest loss time) 
return 


if (server is at anti-amplification limit): 
// The server's timer is not set if nothing can be sent. 
loss detection timer.cancel() 
return 
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if (no ack-eliciting packets in flight && 
PeerCompletedAddressValidation()): 
// There is nothing to detect lost, so no timer is set. 
// However, the client needs to arm the timer if the 
// server might be blocked by the anti-amplification limit. 
loss detection timer.cancel() 
return 


timeout, _ = GetPtoTimeAndSpace() 
loss detection timer.update(timeout) 


A.9. On Timeout 


When the loss detection timer expires, the timer's mode determines the action to be performed. 


Pseudocode for OnLossDetectionTimeout follows: 


OnLossDetectionTimeout(): 

earliest loss time, pn space = GetLossTimeAndSpace() 

if (earliest. loss time != @): 
// Time threshold loss Detection 
lost packets = DetectAndRemoveLostPackets(pn. space) 
assert(!lost_packets.empty() ) 
OnPacketsLost(lost_packets) 
SetLossDetectionTimer() 
return 


if (no ack-eliciting packets in flight): 
assert( !PeerCompletedAddressValidation()) 
// Client sends an anti-deadlock packet: Initial is padded 
// to earn more anti-amplification credit, 
// a Handshake packet proves address ownership. 
if (has Handshake keys): 
SendOneAckElicitingHandshakePacket ( ) 
else: 
SendOneAckElicitingPaddedInitialPacket() 
else: 
// PTO. Send new data if available, else retransmit old data. 
// If neither is available, send a single PING frame. 
_, pn_space = GetPtoTimeAndSpace() 
SendOneOrTwoAckElicitingPackets(pn_space) 


pto_count++ 
SetLossDetectionTimer() 


A.10. Detecting Lost Packets 


DetectAndRemoveLostPackets is called every time an ACK is received or the time threshold loss 
detection timer expires. This function operates on the sent packets for that packet number space 
and returns a list of packets newly detected as lost. 
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Pseudocode for DetectAndRemoveLostPackets follows: 


DetectAndRemoveLostPackets(pn. space): 
assert(largest acked packet[pn space] != infinite) 
loss time[pn space] = @ 
lost packets = [] 
loss delay = kTimeThreshold * max(latest_rtt, smoothed_rtt) 


// Minimum time of kGranularity before packets are deemed lost. 
loss delay = max(loss delay, kGranularity) 


// Packets sent before this time are deemed lost. 
lost send time = now() - loss delay 


foreach unacked in sent packets[pn. space]: 
if (unacked.packet. number > largest acked packet[pn. space]): 
continue 


// Mark packet as lost, or set time when it should be marked. 
// Note: The use of kPacketThreshold here assumes that there 
// were no sender-induced gaps in the packet number space. 
if (unacked.time sent <= lost send time || 
largest acked packet[pn space] >= 
unacked.packet number + kPacketThreshold) : 
sent_packets|[pn_space] .remove(unacked.packet_number ) 
lost packets.insert(unacked) 
else: 
if (loss time[pn space] == ; 
loss time[pn. space] = unacked.time_sent + loss delay 
else: 
loss time[pn. space] = min(loss time[pn space], 
unacked.time. sent + loss delay) 
return lost packets 


A.11. Upon Dropping Initial or Handshake Keys 


When Initial or Handshake keys are discarded, packets from the space are discarded and loss 
detection state is updated. 


Pseudocode for OnPacketNumberSpaceDiscarded follows: 


OnPacketNumberSpaceDiscarded(pn space): 
assert(pn_space != ApplicationData) 
RemoveFromBytesInFlight(sent_packets[pn_space] ) 
sent_packets|[pn_space] .clear() 

// Reset the loss detection and PTO timer 
time_of_last_ack_eliciting_packet[pn_space] = 9 
loss_time[pn_space] = @ 

pto_count = @ 

SetLossDetectionTimer() 
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Appendix B. Congestion Control Pseudocode 


We now describe an example implementation of the congestion controller described in Section 7. 


The pseudocode segments in this section are licensed as Code Components; see the copyright 
notice. 


B.1. Constants of Interest 


Constants used in congestion control are based on a combination of RFCs, papers, and common 
practice. 


kInitialWindow: Default limit on the initial bytes in flight as described in Section 7.2. 
kMinimumWindow: Minimum congestion window in bytes as described in Section 7.2. 


kLossReductionFactor: Scaling factor applied to reduce the congestion window when a new loss 
event is detected. Section 7 recommends a value of 0.5. 


kPersistentCongestionThreshold: Period of time for persistent congestion to be established, 
specified as a PTO multiplier. Section 7.6 recommends a value of 3. 


B.2. Variables of Interest 


Variables required to implement the congestion control mechanisms are described in this 
section. 


max_datagram_size: The sender's current maximum payload size. This does not include UDP or 
IP overhead. The max datagram size is used for congestion window computations. An 
endpoint sets the value of this variable based on its Path Maximum Transmission Unit (PMTU; 
see Section 14.2 of [QUIC-TRANSPORT]), with a minimum value of 1200 bytes. 


ecn_ce_counters[kPacketNumberSpace]: The highest value reported for the ECN-CE counter in 
the packet number space by the peer in an ACK frame. This value is used to detect increases in 
the reported ECN-CE counter. 


bytes in flight: The sum of the size in bytes of all sent packets that contain at least one ack- 
eliciting or PADDING frame and have not been acknowledged or declared lost. The size does 
not include IP or UDP overhead, but does include the QUIC header and Authenticated 
Encryption with Associated Data (AEAD) overhead. Packets only containing ACK frames do 
not count toward bytes_in_flight to ensure congestion control does not impede congestion 
feedback. 


congestion_window: Maximum number of bytes allowed to be in flight. 
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congestion recovery start time: The time the current recovery period started due to the 
detection of loss or ECN. When a packet sent after this time is acknowledged, QUIC exits 
congestion recovery. 


ssthresh: Slow start threshold in bytes. When the congestion window is below ssthresh, the 
mode is slow start and the window grows by the number of bytes acknowledged. 


The congestion control pseudocode also accesses some of the variables from the loss recovery 
pseudocode. 


B.3. Initialization 
At the beginning of the connection, initialize the congestion control variables as follows: 
congestion window = kInitialWindow 
bytes in flight = 9 
congestion recovery start time = @ 
ssthresh = infinite 


for pn_space in [ Initial, Handshake, ApplicationData |: 
ecn. ce counters[pn space] = 9 


B.4. On Packet Sent 


Whenever a packet is sent and it contains non-ACK frames, the packet increases bytes in flight. 


OnPacketSentCC(sent bytes): 
bytes in flight += sent bytes 


B.5. On Packet Acknowledgment 


This is invoked from loss detection's OnAckReceived and is supplied with the newly 
acked packets from sent packets. 


Iyengar & Swett Standards Track Page 39 


RFC 9002 QUIC Loss Detection May 2021 


In congestion avoidance, implementers that use an integer representation for 
congestion window should be careful with division and can use the alternative approach 
suggested in Section 2.1 of [RFC3465]. 


InCongestionRecovery(sent. time): 
return sent time <= congestion recovery. start. time 


OnPacketsAcked(acked_packets) : 
for acked_packet in acked_packets: 
OnPacketAcked(acked_packet) 


OnPacketAcked(acked_packet) : 

if (!acked_packet.in_flight) : 

return; 
// Remove from bytes_in_flight. 
bytes_in_flight -= acked_packet.sent_bytes 
// Do not increase congestion_window if application 
// limited or flow control limited. 
if (IsAppOrFlowControlLimited() ) 

return 
// Do not increase congestion window in recovery period. 
if (InCongestionRecovery(acked_packet.time_sent)): 

return 
if (congestion_window < ssthresh): 

// Slow start. 

congestion_window += acked_packet.sent_bytes 
else: 

// Congestion avoidance. 

congestion_window += 

max_datagram_size * acked_packet.sent_bytes 
/ congestion_window 


B.6. On New Congestion Event 


This is invoked from ProcessECN and OnPacketsLost when a new congestion event is detected. If 
not already in recovery, this starts a recovery period and reduces the slow start threshold and 
congestion window immediately. 


OnCongestionEvent(sent_time) : 
// No reaction if already in a recovery period. 
if (InCongestionRecovery(sent_time) ): 
return 


// Enter recovery period. 
congestion_recovery_start_time = now() 

ssthresh = congestion_window * kLossReductionFactor 
congestion_window = max(ssthresh, kMinimumWindow) 
// A packet can be sent to speed up loss recovery. 
MaybeSendOnePacket() 
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B.7. Process ECN Information 


This is invoked when an ACK frame with an ECN section is received from the peer. 


ProcessECN(ack, pn. space): 
// If the ECN-CE counter reported by the peer has increased, 
// this could be a new congestion event. 
if (ack.ce counter > ecn ce counters[pn.space]): 
ecn. ce counters[pn space] = ack.ce counter 
sent time = sent packets[ack.largest acked].time sent 
OnCongestionEvent(sent time) 


B.8. On Packets Lost 


This is invoked when DetectAndRemoveLostPackets deems packets lost. 


OnPacketsLost(lost_packets) : 
sent_time_of_last_loss = @ 
// Remove lost packets from bytes_in_flight. 
for lost_packet in lost_packets: 
if lost_packet.in_flight: 
bytes_in_flight -= lost_packet.sent_bytes 
sent_time_of_last_loss = 
max(sent_time_of_last_loss, lost_packet.time_sent) 
// Congestion event if in-flight packets were lost 
if (sent_time_of_last_loss != Ø): 
OnCongestionEvent(sent_time_of_last_loss) 


// Reset the congestion window if the loss of these 
// packets indicates persistent congestion. 
// Only consider packets sent after getting an RTT sample. 
if (first_rtt_sample == @): 
return 
pc_lost = [] 
for lost in lost_packets: 
if lost.time_sent > first_rtt_sample: 
pc_lost.insert(lost) 
if (InPersistentCongestion(pc_lost) ): 
congestion_window = kMinimumWindow 
congestion_recovery_start_time = @ 


B.9. Removing Discarded Packets from Bytes in Flight 


When Initial or Handshake keys are discarded, packets sent in that space no longer count toward 
bytes in flight. 
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Pseudocode for RemoveFromBytesInFlight follows: 


RemoveFromBytesInFlight(discarded packets): 
// Remove any unacknowledged packets from flight. 
foreach packet in discarded packets: 
if packet.in flight 
bytes in flight -= size 
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